home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / ver_cont / cvs-1.8 / cvs-1 / cvs-1.8.1 / INSTALL < prev    next >
Encoding:
Text File  |  1996-05-06  |  13.1 KB  |  345 lines
  1. #ident    "$CVSid$"
  2.  
  3. First, read the README file.  If you're still happy...
  4.  
  5. CVS has been tested on the following platforms.  The most recent
  6. version of CVS reported to have been tested is indicated, but more
  7. recent versions of CVS probably will work too.  Please send updates to
  8. this list to bug-cvs@prep.ai.mit.edu (doing so in the form of a diff
  9. to this file is encouraged).
  10.  
  11. Alpha:
  12.     DEC Alpha running OSF/1 version 1.3 using cc (about 1.4A2)
  13.     DEC Alpha running OSF/1 version 2.0 (1.4.90)
  14.     DEC Alpha running OSF/1 version 2.1 (about 1.4A2)
  15.     DEC Alpha running OSF/1 version 3.0 (1.5.95) (footnote 7)
  16.     DEC Alpha running OSF/1 version 3.2 (1.7+obvious patch)
  17. HPPA:
  18.     HP 9000/710 running HP-UX 8.07A using gcc (about 1.4A2)
  19.     HP 9000/715 running HP-UX 9.01 (1.6)
  20.     HPPA running HP-UX 10.01 (1.7)
  21.         HPPA 1.1 running HP-UX A.09.03 (1.5.95) (footnote 8)
  22.         HPPA 1.1 running HP-UX A.09.04 (1.7.1)
  23.     NextSTEP 3.3 (1.6.86)
  24. i386 family:
  25.     Solaris 2.4 using gcc (about 1.4A2)
  26.     UnixWare v1.1.1 using gcc (about 1.4A2)
  27.     ISC 4.0.1 (1.5.94)
  28.     Linux (kernel 1.2.x) (1.7.1)
  29.     BSDI 2.0 (1.4.93) (footnote 5)
  30.     FreeBSD 2.0.5, i486, gcc (1.5.95)
  31.     NextSTEP 3.3 (1.6.86)
  32.     NeXTSTEP 3.3 (1.7), (footnote 10)
  33.     SCO Unix 3.2.4.2 (1.4.93) (footnote 4)
  34.     SCO OpenServer 5.0.0, "CC='cc -b elf' configure"
  35.     Lynx 2.3.0 080695 (1.6.86) (footnote 9)
  36.     Windows NT 3.51 (1.7.87 client-only)
  37.     QNX 4 (1.7 + obvious patches)
  38.     OS/2 Version 3 using IBM C/C++ Tools 2.01 (1.7.86 with patches)
  39. m68k:
  40.     Sun 3 running SunOS 4.1.1_U1 w/ bundled K&R /usr/5bin/cc (1.6)
  41.     NextSTEP 3.3 (1.6.86)
  42.     NeXTSTEP 3.3 (1.7), (footnote 10)
  43.     Lynx 2.3.0 062695 (1.6.86) (footnote 9)
  44. m88k:
  45.     Data General AViiON running dgux 5.4R2.10 (1.5)
  46.     Data General AViiON running dgux 5.4R3.10 (1.7.1)
  47.     Harris Nighthawk 5800 running CX/UX 7.1 (1.5) (footnote 6)
  48. MIPS:
  49.     DECstation running Ultrix 4.2a (1.4.90)
  50.     DECstation running Ultrix 4.3 (1.6.86)
  51.     SGI running Irix 4.0.5H using gcc and cc (about 1.4A2) (footnote 2)
  52.     SGI running Irix 5.3 (1.7)
  53.     SGI running Irix-6 (about 1.4.90) (footnote 3)
  54.     Siemens-Nixdorf RM600 running SINIX-Y (1.6)
  55. PowerPC or RS/6000:
  56.     IBM RS/6000 running AIX 3.1 using gcc and cc (1.6.86)
  57.     IBM RS/6000 running AIX 3.2.5 (1.7.87)
  58.     IBM RS/6000 running AIX 4.1 using gcc and cc (about 1.4A2) (footnote 1)
  59.     Lynx 2.3.1 120495 (1.6.86) (footnote 9)
  60. SPARC:
  61.     Sun SPARC running SunOS 4.1.x (1.6.86)
  62.     Sun SPARCstation 10 running Solaris 2.3 using gcc and cc (about 1.4A2)
  63.     Sun SPARCstation running Solaris 2.4 using gcc and cc (about 1.5.91)
  64.     Sun SPARC running Solaris 2.5 (2.5 beta?) (1.6.4)
  65.     NextSTEP 3.3 (1.6.86)
  66.     NeXTSTEP 3.3 (1.7), (footnote 10)
  67.  
  68. (footnote 1)
  69.     AIX 4.1 systems fail to run "configure" due to bugs in their
  70.     "/bin/sh" implementation.  You might want to try feeding the
  71.     configure script to "bash" ported to AIX 4.1.  (about 1.4A2).
  72.  
  73. (footnote 2)
  74.     Some Irix 4.0 systems may core dump in malloc while running
  75.     CVS.  We believe this is a bug in the Irix malloc.  You can
  76.     workaround this bug by linking with "-lmalloc" if necessary.
  77.     (about 1.4A2).
  78.  
  79. (footnote 3)
  80.         There are some warnings about pointer casts which can safely be
  81.         ignored.  (about 1.4.90).
  82.  
  83. (footnote 4) Comment out the include of sys/time.h in src/server.c. (1.4.93)
  84.     You also may have to make sure TIME_WITH_SYS_TIME is undef'ed.
  85.  
  86. (footnote 5) Change /usr/tmp to /var/tmp in src/server.c (2 places) (1.4.93).
  87.  
  88. (footnote 6) Build in ucb universe with COFF compiler tools.  Put
  89.     /usr/local/bin first in PATH while doing a configure, make
  90.     and install of GNU diffutils-2.7, rcs-5.7, then cvs-1.5.
  91.  
  92. (footnote 7) Manoj Srivastava <srivasta@pilgrim.umass.edu> reports
  93.         success with this configure command:
  94.   CC=cc CFLAGS='-O2 -Olimit 2000 -std1' ./configure --verbose alpha-dec-osf
  95.  
  96. (footnote 8) Manoj Srivastava <srivasta@pilgrim.umass.edu> reports
  97.         success with this configure command:
  98.   CC=cc CFLAGS='+O2 -Aa -D_HPUX_SOURCE' ./configure --verbose hppa1.1-hp-hpux
  99.  
  100. (footnote 9) 
  101.     Had to configure with ./configure --host=<arch>-lynx.
  102.  
  103.     In src/cvs.h, protected the waitpid prototype with ifdef _POSIX_SOURCE.
  104.     (I might try building with gcc -mposix -D_POSIX_SOURCE.)
  105.  
  106.     LynxOS has <dirent.h>, but you don't want to use it.
  107.     You want to use <sys/dir.h> instead.
  108.     So after running configure I had to undef HAVE_DIRENT_H and
  109.     define HAVE_SYS_DIR_H.
  110.  
  111. (footnote 10) Ralf E. Stranzenbach <ralf@reswi.ruhr.de>
  112.     I've made some modifications to "filesubr.c" to deal with NFS
  113.     mounted directories (and those funny .nfs* files). This patch
  114.     should be used whenever the programmers "sandbox" is located on
  115.     a NFS mounted device --- at least on NeXTSTEP.
  116.  
  117. -------------------------------------------------------------------------------
  118.  
  119. Installation under Unix:
  120.  
  121. 1)  Run "configure":
  122.  
  123.     $ ./configure
  124.  
  125.     You can specify an alternate destination to override the default with
  126.     the --prefix option:
  127.  
  128.     $ ./configure --prefix=/usr/local/gnu
  129.  
  130.     or some path that is more appropriate for your site.  The default prefix
  131.     value is "/usr/local", with binaries in sub-directory "bin", manual
  132.     pages in sub-directory "man", and libraries in sub-directory "lib".
  133.  
  134.     If you are using server or local CVS, RCS needs to be installed in
  135.     the user's PATH (or a path you have configured in src/options.h,
  136.     or a path specified with the -b option).  If you don't have RCS,
  137.     you will need to get it from GNU as well.  It is best to get the
  138.     version 5.7 (or later) version of RCS, available from
  139.     prep.ai.mit.edu in the file pub/gnu/rcs-5.7.tar.gz.
  140.  
  141.     If you want version control of files with binary data, make sure
  142.     that the RCS configure script finds GNU diff 1.15 or later and
  143.     notices that diff supports the -a option.  CVS itself is much less
  144.     picky about which version of diff it uses, and you shouldn't need
  145.     to worry about that.
  146.  
  147.     NOTE: The configure program will cache the results of the previous
  148.     configure execution.  If you need to re-run configure from scratch, you
  149.     may need to run "make distclean" first to remove the cached
  150.     configuration information.
  151.  
  152.     If you are using gcc and are planning to modify CVS, you may want to
  153.     configure with -Wall; see the file HACKING for details.
  154.  
  155.     Try './configure --help' for further information on its usage.
  156.  
  157.     NOTE ON CVS's USE OF NDBM:
  158.  
  159.     By default, CVS uses some built-in ndbm emulation code to allow
  160.     CVS to work in a heterogeneous environment.  However, if you have
  161.     a very large modules database, this may not work well.  You will
  162.     need to edit src/options.h to turn off the MY_NDBM #define and
  163.     re-run configure.  If you do this, the following comments apply.
  164.     If not, you may safely skip these comments.
  165.  
  166.     If you configure CVS to use the real ndbm(3) libraries and
  167.     you do not have them installed in a "normal" place, you will
  168.     probably want to get the GNU version of ndbm (gdbm) and install
  169.     that before running the CVS configure script.  Be aware that the
  170.     GDBM 1.5 release does NOT install the <ndbm.h> header file included
  171.     with the release automatically.  You may have to install it by hand.
  172.  
  173.     If you configure CVS to use the ndbm(3) libraries, you cannot
  174.     compile CVS with GNU cc (gcc) on Sun-4 SPARC systems.  However, gcc
  175.     2.0 may have fixed this limitation if -fpcc-struct-return is
  176.     defined.  When using gcc on other systems to compile CVS, you *may*
  177.     need to specify the -fpcc-struct-return option to gcc (you will
  178.     *know* you have to if "cvs checkout" core dumps in some ndbm
  179.     function).  You can do this as follows:
  180.  
  181.         $ CC='gcc -fpcc-struct-return' ./configure
  182.  
  183.     for sh, bash, and ksh users and:
  184.  
  185.         % setenv CC 'gcc -fpcc-struct-return'
  186.         % ./configure
  187.  
  188.     for csh and tcsh users.
  189.  
  190.     END OF NOTE FOR NDBM GUNK.
  191.  
  192. 2)  Edit src/options.h.  Appropriate things to look at may be the
  193.     invocation locations of programs like DIFF and GREP.
  194.     Also glance at the default values for the environment variables
  195.     that CVS uses, in particular, the RCSBIN variable, which holds the
  196.     path to where the RCS programs live on your system.
  197.  
  198. 3)  Try to build it:
  199.  
  200.     $ make
  201.  
  202.     This will (hopefully) make the needed CVS binaries within the
  203.     "src" directory.  If something fails for your system, and you want
  204.     to submit a bug report, you may wish to include your
  205.     "config.status" file, your host type, operating system and
  206.     compiler information, make output, and anything else you think
  207.     will be helpful.
  208.  
  209. 3a)  Run the regression tests (optional).
  210.  
  211.     You may also wish to validate the correctness of the new binary by
  212.     running the regression tests:
  213.  
  214.     $ make check
  215.  
  216.     Note that if your /bin/sh doesn't support shell functions, you'll
  217.     have to try something like this, where "/bin/sh5" is replaced by the
  218.     pathname of a shell which handles normal shell functions:
  219.  
  220.     $ make SHELL=/bin/sh5 check
  221.  
  222.     WARNING:  This test can take quite a while to run, esp. if your
  223.     disks are slow or over-loaded.
  224.  
  225.     If you receive any un-expected output from the regression tests,
  226.     it may indicate a bug in CVS (or might just indicate a problem
  227.     running the tests).  If you choose to submit a bug report,
  228.     be aware that, as with all bug reports, you may or may not get a
  229.     response, and your odds might be better if you include enough information
  230.     to reproduce the bug, an analysis of what is going wrong (if you have
  231.     the time and ability to provide one), etc.  The check.log file is the
  232.     first place to look.
  233.  
  234. 4)  Install the binaries/documentation:
  235.  
  236.     $ make install
  237.  
  238.     Depending on your installation's configuration, you may need to be
  239.     root to do this.
  240.  
  241. 5)  Take a look at the CVS documentation.
  242.  
  243.     $ man cvs
  244.  
  245.     and
  246.  
  247.     $ info cvs  
  248.  
  249.     See what it can do for you, and if it fits your environment (or can
  250.     possibly be made to fit your environment).  If things look good,
  251.     continue on...
  252.  
  253. 6)  Set up the master source repository.  See the "Setting up the repository"
  254.     section of cvs.texinfo for details; the one-line summary is (if you
  255.     are putting the repository in /src/master):
  256.     $ cvs -d /src/master init
  257.  
  258. 7)  Have all users of the CVS system set the CVSROOT environment
  259.     variable appropriately to reflect the placement of your source
  260.     repository.  If the above example is used, the following commands
  261.     can be placed in user's ~/.profile, ~/.bash_profile file; or in the
  262.     site-wide /etc/profile:
  263.  
  264.     CVSROOT=/src/master; export CVSROOT
  265.  
  266.     for sh/bash/ksh users, or place the following commands in the user's
  267.     ~/.cshrc, ~/.login, or /etc/chsrc file:
  268.  
  269.     setenv CVSROOT /src/master
  270.  
  271.     for csh/tcsh users.  If these environment variables are not already set
  272.     in your current shell, set them now (or source the login script you
  273.     just edited).  You will need to have the CVSROOT environment variable
  274.     set to continue on to the next step.
  275.  
  276. 8)  It might be a good idea to jump right in and put the CVS distribution
  277.     directly under CVS control.  From within the top-level directory of the
  278.     CVS distribution (the one that contains this README file) do the
  279.     following commands:
  280.  
  281.     $ make distclean
  282.     $ cvs import -m 'CVS 1.6 distribution' cvs CVS_DIST CVS-1_6
  283.  
  284. 9)  Having done step 8, one should be able to checkout a fresh copy of the
  285.     CVS distribution and hack away at the sources with the following command:
  286.  
  287.     $ cd
  288.     $ cvs checkout cvs
  289.  
  290.     This will make the directory "cvs" in your current directory and
  291.     populate it with the appropriate CVS files and directories.
  292.  
  293. 10) You may wish to customize the various administrative files, in particular
  294.     modules.  See cvs.texinfo for details.
  295.  
  296. 11) Read the NEWS file to see what's new.
  297.  
  298. 12) Hack away.
  299.  
  300. -------------------------------------------------------------------------------
  301.  
  302. Detailed information about your interaction with "configure":
  303.  
  304. The "configure" script and its interaction with its options and the
  305. environment is described here.  For more detailed documentation about
  306. "configure", please refer to the GNU Autoconf documentation.
  307.  
  308. Supported options are:
  309.  
  310.     --srcdir=DIR        Useful for compiling on many different
  311.                 machines sharing one source tree.
  312.     --prefix=DIR        The root of where to install the
  313.                 various pieces of CVS (/usr/local).
  314.     --exec_prefix=DIR    If you want executables in a
  315.                 host-dependent place and shared
  316.                 things in a host-independent place.
  317.  
  318. The following environment variables override configure's default
  319. behaviour:
  320.  
  321.     CC            If not set, tries to use gcc first,
  322.                 then cc.  Also tries to use "-g -O"
  323.                 as options, backing down to -g
  324.                 alone if that doesn't work.
  325.     INSTALL            If not set, tries to use "install", then
  326.                 "./install-sh" as a final choice.
  327.     RANLIB            If not set, tries to determine if "ranlib"
  328.                 is available, choosing "echo" if it doesn't
  329.                 appear to be.
  330.     YACC            If not set, tries to determine if "bison"
  331.                 is available, choosing "yacc" if it doesn't
  332.                 appear to be.
  333.  
  334. -------------------------------------------------------------------------------
  335. Installation under Windows NT:
  336.  
  337. You may find interesting information in windows-NT/README.
  338.  
  339. 1) Using Microsoft Visual C++ version 2.1, open the project `cvsnt.mak',
  340.    in the top directory of the CVS distribution.
  341. 2) Choose "Build cvs.exe" from the "Project" menu.
  342. 3) MSVC will place the executable file cvs.exe in WinDebug, or whatever
  343.    your target directory is.
  344. -------------------------------------------------------------------------------
  345.